Inside Macintosh: Telephony /

Chapter 6 - Telephone Tools / Telephone Tools Reference

Tool-Defined Functions /

MyVLOC

Called to handle localization operations.

pascal long MyVLOC (
                     TELHandle hTEL, 
                     short msg, 
                     long p1, 
                     long p2, 
                     long p3);

hTEL

A handle to a telephone record for the user's terminal.

msg

A constant that identifies the type of message being sent to the telephone tool. See "Localization Code Resource Messages," beginning on page 6-43 for a complete description of the available messages for a localization code resource.

p1

The first parameter for the specified message.

p2

The second parameter for the specified message.

p3

The third parameter for the specified message.

function result

A result code. See the description below for specific codes you can return.

DESCRIPTION

The MyVLOC function is the entry point to the localization code resource of a telephone tool. It should inspect the message specified by the msg parameter and respond accordingly. Currently, a localization code resource should accept these two messages:

enum {
   telL2EnglishMsg         = 0,
   telL2IntlMsg            = 1
};

The meaning of the parameters p1, p2, and p3 is dependent on the message type specified by the msg parameter. See the descriptions of the localization code resource messages beginning on page 6-40 for information about these parameters for each message.

Your MyVSCR function should return, as its function result, a result code indicating the outcome of the request. You can return an operating-system result code or a Telephone Manager result code. If your function receives any message other than the two listed above, it should return the code telNotSupported.